批量修改任务基本配置
批量修改任务基本配置
- 请求地址: /v2/webservice/table/analysis-export-task/batch-update-common-config
- 请求方法: POST
- 接口描述: 批量修改任务的通用配置(run_task_time、make_data_time、api_write_interface)
请求参数
请求体参数
| 参数名 | 类型 | 必填 | 描述 |
|---|
| app_id | number | 是 | 应用 ID |
| task_names | string[] | 是 | 需要修改的任务名列表(至少1个) |
| run_task_time | string | 否 | 每天启动时间,格式 HH:mm:ss,不得小于 03:00:00 |
| make_data_time | string | 否 | 要构造的数据时间,格式 HH:mm:ss,为空代表构造到冷备时间点数据 |
| api_write_interface | number | 否 | 写入数据方式,1: setData, 2: setKey&setValue |
请求示例
示例1:批量修改启动时间
{
"app_id": 100915,
"task_names": ["task_001", "task_002", "task_003"],
"run_task_time": "10:00:00"
}
示例2:批量修改多个配置
{
"app_id": 100915,
"task_names": ["task_001", "task_002"],
"run_task_time": "18:00:00",
"make_data_time": "09:00:00",
"api_write_interface": 1
}
示例3:仅修改数据写入方式
{
"app_id": 100915,
"task_names": ["task_001"],
"api_write_interface": 2
}
返回参数
| 参数名 | 类型 | 描述 |
|---|
| code | number | 错误码,0 表示成功 |
| message | string | 错误信息,成功时为 “success” |
| data | object | 返回数据 |
| data.task_list | array | 任务修改结果列表 |
task_list 数组元素参数
| 参数名 | 类型 | 描述 |
|---|
| app_id | number | 应用 ID |
| task_name | string | 任务名称 |
| task_id | number | 事务 ID |
| result | number | 操作结果状态码 |
返回示例
成功返回
{
"code": 0,
"message": "success",
"data": {
"task_list": [
{
"app_id": 100915,
"task_name": "task_001",
"task_id": 123456,
"result": 0
},
{
"app_id": 100915,
"task_name": "task_002",
"task_id": 123457,
"result": 0
}
]
}
}
失败返回
{
"code": 102,
"message": "以下任务不存在",
"data": {
"not_exist_task_names": ["task_999"]
}
}